/* tzdb 代码的私有头文件。  */

#ifndef PRIVATE_H

#define PRIVATE_H

/*
 * 本文件属于公有领域，因此于
 * 1996-06-05 由 Arthur David Olson 予以澄清。
 *
 * 标识
 *	  src/timezone/private.h
 */

/*
 * 此头文件仅供时间转换代码使用。
 * 不保证其会保持不变，
 * 或者会一直存在。
 * 请勿将其复制到任何系统包含目录。
 * 谢谢！
 */

#include <limits.h>				/* 用于 CHAR_BIT 等。 */
#include <sys/wait.h>			/* 用于 WIFEXITED 和 WEXITSTATUS */
#include <unistd.h>				/* 用于 F_OK 和 R_OK */

#include "pgtime.h"

/* 该字符串在 2016f 版本中属于 Factory 时区。  */
#define GRANDPARENTED	"Local time zone must be set--see zic manual page"

/*
 * IANA 这里有一堆 HAVE_FOO 的 #defines，但在 PG 中我们希望
 * 几乎所有的都由 PG 的配置脚本处理。
 */

#ifndef ENOTSUP
#define ENOTSUP EINVAL
#endif
#ifndef EOVERFLOW
#define EOVERFLOW EINVAL
#endif

/* 与 <ctype.h> 的 isdigit 不同，c < 0 | c > UCHAR_MAX 时也能工作。 */
#define is_digit(c) ((unsigned)(c) - '0' <= 9)

/* PG 目前不依赖 <inttypes.h>，因此会规避 strtoimax() */
#undef strtoimax
#ifdef HAVE_STRTOLL
#define strtoimax strtoll
#else
#define strtoimax strtol
#endif


/*
 * 最后，一些便利的项目。
 */

#define TYPE_BIT(type)	(sizeof (type) * CHAR_BIT)
#define TYPE_SIGNED(type) (((type) -1) < 0)
#define TWOS_COMPLEMENT(t) ((t) ~ (t) 0 < 0)

/*
 * 整数类型 T 的最大值和最小值，其中仅使用最低的 B 位，
 * 最高的有效位在 T 为带符号时被视为符号位。
 */
#define MAXVAL(t, b)						\
  ((t) (((t) 1 << ((b) - 1 - TYPE_SIGNED(t)))			\
	- 1 + ((t) 1 << ((b) - 1 - TYPE_SIGNED(t)))))
#define MINVAL(t, b)						\
  ((t) (TYPE_SIGNED(t) ? - TWOS_COMPLEMENT(t) - MAXVAL(t, b) : 0))

/* 极限时间值，假设没有填充。  */
#define TIME_T_MIN MINVAL(pg_time_t, TYPE_BIT(pg_time_t))
#define TIME_T_MAX MAXVAL(pg_time_t, TYPE_BIT(pg_time_t))

/*
 * 302 / 1000 是 log10(2.0) 向上取整。
 * 如果类型为带符号，则减去一个符号位；
 * 对于整数除法截断加一；
 * 如果类型为带符号，则再加一个负号。
 */
#define INT_STRLEN_MAXIMUM(type) \
	((TYPE_BIT(type) - TYPE_SIGNED(type)) * 302 / 1000 + \
	1 + TYPE_SIGNED(type))

/*
 * INITIALIZE(x)
 */
#define INITIALIZE(x)	((x) = 0)

#undef _
#define _(msgid) (msgid)

/* 独立于 tzfile 实现的便捷宏。  */

#define YEARSPERREPEAT		400 /* 公历重复的年份 */

#define SECSPERMIN	60
#define MINSPERHOUR 60
#define HOURSPERDAY 24
#define DAYSPERWEEK 7
#define DAYSPERNYEAR	365
#define DAYSPERLYEAR	366
#define SECSPERHOUR (SECSPERMIN * MINSPERHOUR)
#define SECSPERDAY	((int32) SECSPERHOUR * HOURSPERDAY)
#define MONSPERYEAR 12

#define TM_SUNDAY	0
#define TM_MONDAY	1
#define TM_TUESDAY	2
#define TM_WEDNESDAY	3
#define TM_THURSDAY 4
#define TM_FRIDAY	5
#define TM_SATURDAY 6

#define TM_JANUARY	0
#define TM_FEBRUARY 1
#define TM_MARCH	2
#define TM_APRIL	3
#define TM_MAY		4
#define TM_JUNE		5
#define TM_JULY		6
#define TM_AUGUST	7
#define TM_SEPTEMBER	8
#define TM_OCTOBER	9
#define TM_NOVEMBER 10
#define TM_DECEMBER 11

#define TM_YEAR_BASE	1900

#define EPOCH_YEAR	1970
#define EPOCH_WDAY	TM_THURSDAY

#define isleap(y) (((y) % 4) == 0 && (((y) % 100) != 0 || ((y) % 400) == 0))

/*
 * 由于 isleap 中的一切都是模 400（或 400 的因子），我们知道
 *	isleap(y) == isleap(y % 400)
 * 因此
 *	isleap(a + b) == isleap((a + b) % 400)
 * 或
 *	isleap(a + b) == isleap(a % 400 + b % 400)
 * 即使 % 意味着模运算而不是 Fortran 余数
 * （C89 允许但 C99 或更高版本不允许）。
 * 我们用这个来避免加法溢出问题。
 */

#define isleap_sum(a, b)	isleap((a) % 400 + (b) % 400)


/*
 * 公历年平均 365.2425 天，即 31556952 秒。
 */

#define AVGSECSPERYEAR		31556952L
#define SECSPERREPEAT \
  ((int64) YEARSPERREPEAT * (int64) AVGSECSPERYEAR)
#define SECSPERREPEAT_BITS	34	/* ceil(log2(SECSPERREPEAT)) */

#endif							/* !defined PRIVATE_H */
